

Tag 


Attributes 


Text 


Description 




<cli> 


! ! i 
j • j Contains zero or more modes j 


lie ^ 


<mode> 


name 




Contains zero or more command ' 
tags. Attribute is required. { 




' <command> 






Contains a required keyword tag. 




<keyword> 


text 




Contains zero or more keyword 
tags, with an optional action or 
help tag. Attribute is required. 


fll 


<help> 




Yes 


May be embedded in keyword 
or arg elements. 


CO 


' <acuon> 


object 
method 




Contains zero or more arg tags. 
The attributes are requi red- 


y. 

3" s 


<arg> 






Contains a single instance of type 
tag, may contain a help tag. 




<type> 


Type 




Empty tag. Attribute is required, 
must be a valid java type. 



FIGURE i 



Command ' 

~ " " * * * 7hu May 

.Tie source : s user conf icura: :or. 



■- Xi-ni vers ion= '* 1 . 0 " encodings '"JS-ASCI I " ? > 

' D0C7YPE cii SYSTEM w cli.dcd"> 

cii> 

mode name = "global * > 



comma nd> 

< keyword text = " show > 

<help>Show running syscem in£ormation</help> 
... <!-iots of other show keywords... 



<keyword cexc = *clock i '> 

<?help>display the system cieck</help> 2 1*2* 

<action object=*Clock" method* - show* > ' 

< /action> 



< keyword texts'detai l *> 

<help>Display detailed information </help> 
action objects "Clock* methods * showDetail * > 
</action> t 
</keyword> ^ _ { - 

</keyword> 2/> 
</keyword> 
</command> 
</mode> 
</cli> 
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Correnand 



Command > :.:z< s e i WW '. \ 

: :■: MTH M~r.:- : : 1*9 /ear 

Command > z.zc:< sec :0:00:: I: Sec 
< 1 ;9 3 - : : I : > Year 



Command > clock sec 00:00:30 2 5 3ep IZZ'j 
Command > 



<command> 3 X7 

<key^ord cext = * clock* > * 

<heip>Manage che System clock</heip> 
<keyvord cext=" set*> ^*Sl% 

<help> Set che time and date</help> t<\a 
<action objects-Clock' methods * sec *> -^-Oi 7 
<arg> <!-time argument --> 

<cype cyps=* java . land - String - ></ crpe> T 2 ^ 
<help>hh:mm: S3 Current Time </heip>' — '~ 
</arg> 

<arg> <!-day of the month argument --> 

<type type** java. lang. Integer" ></cype> . 
<help>< l-31&gt ; Day of the monch</help>*v* O ?5 
</arg> 

<arg> <!-day of the month argument --> 

<type types* ]ava . lang . Integer * >< / type> 
<help>MONTH Month of the year </help>^5-fo 

</arg> 

<arg> <!-year argument - - > 

<type cypes- java . lang . Integer - ></ cype> 
<help>< 1993-20354gt; Year</heip> ^Ot5 
</arg> 
</act ion> 
< / keyword> 
< / keyvord> 
< / command> 
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<?xml version='l.O' encoding='us-ascii"?> 
<!— DTD for the cli description file -> 

<! — The cli tag is the topmost element. Contains zero or more modes. •-> 
<!ELEMENT cli (mode*)> 

<!-The mode tag contains zero or more command tags. The mode must 
have a name, for example "global", "exec", "config" --> 
<!ELEMENT mode (command*)> 
<!ATTLIST mode 

name CDATA #REQUIRED 
> 

<! — The command tag contains a single keyword --> 
! ELEMENT command (keyword)> 

<!--The keyword tag contains zero or more subkeywords, with an optional 
single instance of action or help. The single attribute is the keyword test 
which must be present -> 
.'ELEMENT keyword ((keyword)*, action?, heip?)> 
<!ATTLIST keyword 

test CDATA #REQUIRED 

> 

<!- The action tag contains zero or more argument tags. The "object" 
and "method" attributes must be present and defined" 
<! ELEMENT action (arg*)> 
<!ATTLIST action 

object CDATA #REQUIRED 

method CDATA #REQUIRED 

> 

<!- The arg tag contains a single instance of a type tag and an 
optional help tag -> 
<! ELEMENT arg (type, help?)> 

<!- The type tag is an empty tag with a required attribute "type". The 

value of the attribute should be a Java class name -> 
<!ELEMENT type EMPTY> 
<!ATTLIST arg 

type CDATA #REQUIRED 

> 



<! - The help tag enloses some text -> 
<!ELEMENT help (#PCDATA)> 
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I 

t 

i 
i 


Command 


Keyword Set 


i 


-how date 


I "-how *. ■date" ! 




*hi«w date detail 


I'Miow". "date", "detail** ) ' 


i 

1 Jock *et 

i 


i "clock *, set * J 1 
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Argument 
Number 


Argument Description 


Argument Help 


i 


Time in 00:00:00 format 


hh:mm:ss Current Time 




day of the month in integer 

format 


<1-31> Day of che month 


3 


month in three letter 
format 


MONTH Month of the Year 


4 


Year in integer format 


<1993-2035> Year 
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Command 
Keyword Sequence 


Help 


show 


Show running system Information 


clock 


Manage che system clock 


Nhow clock 


Display the system clock 


>how clock detail 


Display detailed information 


clock >et 


Set the time and date 
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r 


d. 


r 


Argument Number 


Argument Description 


Java Type 


i 


Time in 00 00:00 format 


; ava . Lang . 3~ r :r.a ' 


•> 


dav of month mteser format 
• 


; ava . 1 ar.g . Integer 


, 

•* 


Vtonth in three letter format 


; ava . lang . St r ir.g 




Year in integer format 


; ava . iang . Integer 
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<?xml version='1.0 encoding='US- ASCII' ?> 
<! DOCTYPE cli SYSTEM "cli.dtd"> 
<cli> 

<mode name="exec"> 



<command> 

<keyword text="show"> 

<help>Show running system information</help> 
.... <!~lots of other show keywords... ~> 

<keyword text="clock'> 
</help>Display the system clock </help> 
<action object= "Clock" method= "show"> 
</action> 



<keyword text="detail"> 
<help>Display detailed information</help> 
action object= "Clock" method="showDetail" 
</action> 
</keyword> 
</keyword> 
</command> 
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<command> 

<keyword text= "clock" 
<help>Manage the System clock</help> 

<keyword test="set"> 

<help> Set the time and date</help> 

<action object= "Clock" method="set /, > 

<arg><!— time argument — > 

<type type="Java.land.String"></type> 

<help>hh:mm:ss Current time</help> 

</arg> 

<arg> <! - day of the month argument -> 
<type type="Java.land.Integer"x/type> 
<help><l-31> day of the month</help> 
</arg> 

<arg> <! — day of the month argument -> 
<type type="Java.land.Integer / 'x/type> 
<help>MONTH Month of the year</help> 
</arg> 

<arg> <! - year argument -> 

<type type="Java.land.Integer"x/type> 

<help>&l t;1993-2035> Year</help> 

</arg> 

</action> 
</keyword> 
</keyword> 
</command> 
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public void show () { 

SimpleDateFormat formatter = 

new SimapleDateFormat ("hh:mm:ss.SSS zzz EEE 
MMM dd yyyy"); 

System.out.println("*" + formatter.format 
(new Date())); 
} 

public void showDetail () { 

this.show(); 

if (Clock.sourceO) 

System.out.println ("Time source is user 
configuration"); 

else 

System.outprintln ("No time source"); 

} 
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public void set (String time, Integer day, String month, Integer year) 

throws IOException, InterruptedException, CLIArgumentException 
{ 

/ / Validate the arguments 
SimpleDateFormat format = new SimpleDateFormat ("hh:mm:ss); 
format.setLenient (false); 
try { format parse (time) 
} catch (ParseException e) { 

throw new ArgumentException (1); 

} 

if (day.intValueO < 1 | | day.intValue() > 31) 
throw new ArgumentException (2); 

format.applyPattern ("MMM"); 
try { format.parse(month); 
} catch (ParseException e) { 

throw new ArgumentException (3); 

} 

if (year.intValue() < 1993 | | year.intValue () > 2035 
throw new ArgumentException (4); 

// One last check for day, month and year validity (e.g., Feb 31) 
format.applyPattern ("dd MMM yyy"); 
try { format.parse(day.toString() + month + year.toStringO); 
} catch (parseException e) { 

CLIEngine.out.println("Invalid date (doesn't exist)"); 

Return; 

I 

/ / Do the actual work 
String [] and = {"/bin/ date", "-s", time + "" + day + " " + month + " " + 

}; 

Process proc = Runtime.getRuntime().exec (cmd); 

proc.waitFor(); 

if (proc.exitValue() > 0) { 

CLIEngine.err.println( // Operation not permitted"); 
return; 

} 

clock.sourceSet(); 
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